Skip to content

[Performance] Memoize isVerbose and isUnitTest in local context#7566

Merged
gonzaloriestra merged 1 commit into
mainfrom
jules-performance-memoize-env-checks-7311632441309857235
May 22, 2026
Merged

[Performance] Memoize isVerbose and isUnitTest in local context#7566
gonzaloriestra merged 1 commit into
mainfrom
jules-performance-memoize-env-checks-7311632441309857235

Conversation

@gonzaloriestra
Copy link
Copy Markdown
Contributor

@gonzaloriestra gonzaloriestra commented May 17, 2026

WHY are these changes introduced?

Performance-obsessed optimization for hot paths. Environment checks like isVerbose and isUnitTest are static during the execution of a CLI command but are often checked repeatedly (e.g., in every outputDebug call).

WHAT is this pull request doing?

This PR implements lazy-initialized memoization for isVerbose and isUnitTest in packages/cli-kit/src/public/node/context/local.ts.

  • Adds memoizedIsVerbose and memoizedIsUnitTest module-level variables.
  • Implements a check to ensure memoization only occurs when using process.env.
  • Bypasses the cache when a custom env object is passed (crucial for unit tests).
  • Adds comments explaining the rationale and safety of the optimization.

How to test your changes?

CI

Checklist

  • I've considered possible cross-platform impacts (Mac, Linux, Windows)
  • I've considered possible documentation changes
  • I've considered analytics changes to measure impact
  • The change is user-facing — I've identified the correct bump type (patch for bug fixes · minor for new features · major for breaking changes) and added a changeset with pnpm changeset add

PR created automatically by Jules for task 7311632441309857235 started by @gonzaloriestra

@google-labs-jules
Copy link
Copy Markdown

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.


For security, I will only act on instructions from the user who triggered this task.

@github-actions github-actions Bot added the no-changelog This PR doesn't include a changeset entry. Is an internal only change not relevant to end users. label May 17, 2026
@gonzaloriestra gonzaloriestra added the Jules Created by Jules label May 18, 2026
@gonzaloriestra gonzaloriestra marked this pull request as ready for review May 18, 2026 12:07
@gonzaloriestra gonzaloriestra requested a review from a team as a code owner May 18, 2026 12:07
Comment thread .jules/bolt.md Outdated
Comment thread packages/cli-kit/src/public/node/context/local.ts
Comment thread packages/cli-kit/src/public/node/context/local.ts
Comment thread packages/cli-kit/src/public/node/context/local.ts
Comment thread packages/cli-kit/src/public/node/context/local.ts
@gonzaloriestra gonzaloriestra force-pushed the jules-performance-memoize-env-checks-7311632441309857235 branch from 62d5fcb to 48483cf Compare May 20, 2026 12:52
@gonzaloriestra gonzaloriestra requested a review from a team as a code owner May 20, 2026 12:52
@gonzaloriestra gonzaloriestra force-pushed the jules-performance-memoize-env-checks-7311632441309857235 branch 2 times, most recently from a580b9b to 36245d8 Compare May 20, 2026 13:48
@github-actions
Copy link
Copy Markdown
Contributor

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

  • Some seemingly private modules might be re-exported through public modules.
  • If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

We found no new type declarations in this PR

Existing type declarations

packages/cli-kit/dist/public/node/context/local.d.ts
@@ -11,6 +11,7 @@ export declare function isTerminalInteractive(): boolean;
  * @returns The path to the user's home directory.
  */
 export declare function homeDirectory(): string;
+export declare function resetEnvironmentMemoization(): void;
 /**
  * Returns true if the CLI is running in debug mode.
  *

@gonzaloriestra gonzaloriestra force-pushed the jules-performance-memoize-env-checks-7311632441309857235 branch from 36245d8 to 6fd3241 Compare May 20, 2026 13:57
Memoize the result of `isVerbose` and `isUnitTest` when called with
`process.env`. These checks are performed frequently in hot paths
like logging (`outputDebug`), and memoizing them avoids repeated
`process.argv.includes` scans and redundant environment variable
lookups.

The memoization explicitly bypasses the cache when a custom environment
object is provided, ensuring test isolation remains intact.

Performance impact:
- Reduces overhead in high-frequency logging paths.
- Avoids O(N) array scans for the `--verbose` flag on every debug log.
@gonzaloriestra gonzaloriestra force-pushed the jules-performance-memoize-env-checks-7311632441309857235 branch from 6fd3241 to 0f0944b Compare May 20, 2026 13:59
Copy link
Copy Markdown
Contributor Author

gonzaloriestra commented May 22, 2026

Merge activity

  • May 22, 7:24 AM UTC: A user started a stack merge that includes this pull request via Graphite.
  • May 22, 7:24 AM UTC: @gonzaloriestra added this pull request to the GitHub merge queue with Graphite.

@gonzaloriestra gonzaloriestra added this pull request to the merge queue May 22, 2026
Merged via the queue into main with commit ae52b1a May 22, 2026
26 of 28 checks passed
@gonzaloriestra gonzaloriestra deleted the jules-performance-memoize-env-checks-7311632441309857235 branch May 22, 2026 07:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Jules Created by Jules no-changelog This PR doesn't include a changeset entry. Is an internal only change not relevant to end users.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants